home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / demos / a-d / blitzbasic21 / examples / cd32lib / cd32lib.doc < prev    next >
Encoding:
Text File  |  1995-09-25  |  3.1 KB  |  111 lines
  1. ;
  2. ; place the cd32lib.obj in blitz2:userlibs/beta/ then read this...
  3. ;
  4.  
  5. #cd32lib=113
  6.  
  7. WriteCD32Mem (AppName$,FileName$,Address,Length/10)
  8. ReadCD32Mem  (AppName$,FileName$,Address,Length/10)
  9. InitCD32
  10. ExamineCD32
  11. PlayCD32 track#[,numtracks]
  12. StopCD32
  13. ControlCD32
  14. TocCD32
  15. ConfigCD32 [&TagList]
  16. ReadCD32 (CD_Offset,Address,Length)
  17.  
  18. Overview of CD32 library for Blitz2
  19. -----------------------------------
  20.  
  21. The cd32lib provides a simple interface to controlling the
  22. cd32's audio and nonvolatile memory features.
  23.  
  24. Only a subset of the commands will be required for developers
  25. porting their games to CD32, the rest are only useful for
  26. general AudioCD player type software.
  27.  
  28. Nonvolatile Memory
  29. ------------------
  30.  
  31. To store a games highscore table in CD32 memory the author
  32. must first transfer the data to a sequential segment of
  33. RAM and then use the WriteCD32Mem command which handles
  34. data in multiples of 10 bytes.
  35.  
  36. See the test.bb example in this directory for an example.
  37.  
  38. Playing Audio Tracks
  39. --------------------
  40.  
  41. Instructing the CD32 to play an audio track is simply a
  42. matter of using the PlayCD32 command.
  43.  
  44. The InitCD32 command should however be used first, and
  45. if the result is false (ie software is NOT running on
  46. CD32) your software should not call any other CD32
  47. commands.
  48.  
  49. Unlike the CD32Mem commands we have found that the CD32
  50. audio commands can be used in Blitz mode, although if
  51. things start going weird....
  52.  
  53.  
  54. Function: InitCD32
  55.  
  56. If InitCD32 returns true then it is ok to use the following
  57. commands, if false then no there is no cd32 or compatible
  58. available so don't even try.
  59.  
  60.  
  61. Function: ExamineCD32 ;-1=programdisk 0=nodisk n=number of tracks
  62.  
  63. ExamineCD32 is useful for programs that allow disk swapping,
  64. it can be used to ensure the programdisk that the game was run
  65. from is present, or if there is no disk or if a standard music
  66. CD has been inserted. It is feasible that you allow users to
  67. play music cd's while playing you game and then be able to ask
  68. them to insert the game disk when more data is required.
  69.  
  70.  
  71. PlayCD32 track#[,numtracks]
  72.  
  73. Makes the CD32 go boom tiddly pom depending on what type of
  74. music track is specified... ie should/will/definately play
  75. start the CD32 playing the track sprecified.
  76.  
  77.  
  78. StopCD32
  79.  
  80. No explanation necesary, well it is sort of self explanatory...
  81.  
  82.  
  83. ControlCD32 ;0=play 1=pause 2=ffwd 3=rewind
  84.  
  85. Yup, pretty straight forward here.
  86.  
  87.  
  88. TocCD32 ;returns location of the toc read by Examine
  89.  
  90. Hmmm, demo code required here. After using the ExamineCD32 command
  91. you can find out the length of each track by examining the TOC data
  92. (Table Of Contents) a sort of Audio CD directory command.
  93.  
  94.  
  95. ConfigCD32 [&TagList] ;can return ¤tconfig
  96.  
  97. Tags are available for 2x speed and 1xspeed and other things.
  98. Interesting to note any CD can be turned into the chipmunk
  99. edition by telling CD32 to switch to 2xspeed and then using
  100. playtrack, or was that playtrack and then 2xspeed... Anyway
  101. it does work.
  102.  
  103.  
  104. ReadCD32 (CD_Offset,Address,Length)
  105.  
  106. Wo, only good for lowlevel people who want to protect their
  107. software in more ways than one. Using commands like this will
  108. definately make your game non hard drive installable.
  109.  
  110.  
  111.